# 📸 로고삽입기 v1.0.0

사진에 회사 로고를 **자동으로 삽입**하는 프로그램입니다.

---

## 🚀 빠른 시작

### 1단계: 프로그램 실행
`로고삽입기.exe`를 더블클릭합니다.

### 2단계: 폴더 선택
처리할 사진이 있는 폴더를 선택합니다.
- 폴더 내 모든 사진이 자동으로 처리됩니다
- 서브 폴더의 사진도 함께 처리됩니다

### 3단계: 완료 대기
처리가 완료되면 다음 메시지가 표시됩니다:
```
✅ 모든 파일이 정상 처리되었습니다.
```

### 4단계: 결과 확인
새로운 폴더가 생성됩니다:
```
폴더명_로고삽입완료_20260703_120530
```
이 폴더 안에 로고가 삽입된 사진들이 저장됩니다.

---

## ⚙️ 설정 변경

### 로고 변경
`assets/` 폴더에 있는 로고 파일을 수정합니다:
- `logo_left.png` → 왼쪽 로고 (가로 12%, 세로 30%)
- `logo_right.png` → 오른쪽 로고 (가로 12%, 세로 30%)

**새 로고 추가 시:**
1. `logo_left.png` 또는 `logo_right.png`를 같은 이름으로 저장
2. 기존 파일 덮어쓰기

### 전화번호 변경
`config.json` 파일을 텍스트 편집기(메모장)로 열어 수정합니다:

```json
"phone_text": {
  "enabled": true,
  "text": "042-826-0326",    ← 이 부분 변경
  ...
}
```

### 고급 설정
더 자세한 설정은 `config.json`의 다음 항목을 수정할 수 있습니다:

| 항목 | 설명 |
|------|------|
| `width_percent` | 로고 크기 (% 단위) |
| `margin` | 로고와 모서리 거리 |
| `font_size_percent` | 전화번호 텍스트 크기 |
| `stroke_width` | 전화번호 텍스트 테두리 두께 |

---

## 📋 지원 파일 형식

- `.jpg` / `.jpeg`
- `.png`
- `.webp`
- `.heic`

---

## 📁 폴더 구조

```
로고삽입기/
├── 로고삽입기.exe          (프로그램)
├── _internal/            (프로그램 라이브러리)
├── config.json           (설정 파일)
├── README.md             (이 파일)
├── DEPLOYMENT.md         (배포 설명서)
└── assets/
    ├── logo_left.png     (왼쪽 로고)
    └── logo_right.png    (오른쪽 로고)
```

---

## ✅ 주요 기능

- **자동 방향 감지** : 사진의 방향에 맞게 로고 크기 자동 조절
- **배치 처리** : 수십 개의 사진을 한 번에 처리
- **원본 보존** : 원본 사진 폴더는 건드리지 않음
- **폴더 구조 유지** : 서브 폴더 구조 그대로 유지
- **로그 기록** : 모든 작업 기록을 자동으로 저장
- **전화번호 삽입** : 로고와 함께 전화번호 텍스트 추가

---

## 🆘 문제 해결

**Q: "설정 파일을 로드할 수 없습니다" 오류가 나옵니다**
- A: `config.json` 파일이 `로고삽입기.exe` 옆에 있는지 확인하세요.

**Q: 로고가 제대로 보이지 않습니다**
- A: `assets/` 폴더에 로고 파일(PNG 형식)이 있는지 확인하세요.
  - 파일명: `logo_left.png`, `logo_right.png`

**Q: 처리된 사진이 어디에 있습니까?**
- A: 원본 폴더와 같은 위치에 `폴더명_로고삽입완료_날짜_시간` 폴더가 생성됩니다.

**Q: 더 많은 로고를 추가할 수 있습니까?**
- A: `config.json` 파일의 `logos` 배열에 새 항목을 추가할 수 있습니다.
  - 기술 지원이 필요하면 관리자에게 문의하세요.

---

## 📝 주의사항

- 프로그램 실행 중에는 입력 폴더를 수정하지 마세요.
- 결과 폴더에 같은 이름의 사진이 있으면 덮어씌워집니다.
- 처리된 사진의 질감이 변할 수 있습니다 (압축 설정에 따라).

---

## 📞 지원

이 프로그램에 대한 문의사항이 있으시면 관리자에게 연락하세요.

**버전:** 1.0.0  
**최종 수정:** 2026-07-03
